本文介绍如何使用行空板 K10 与 SIoT 通信,并分别用 Mind+ 的 上传模式、MicroPython 积木模式 和 MicroPython 代码模式 完成两个项目:

  1. 行空板 K10 上传温度数据到 SIoT。
  2. SIoT 发送控制指令,让行空板 K10 控制 RGB 灯打开或关闭。

为了便于学习,本文将三种编程方式分开编写。建议初学者先完成 上传模式,再对照学习 MicroPython 积木模式 和 MicroPython 代码模式。

行空板 K10 自带温度传感器、屏幕、RGB 灯 and Wi-Fi 能力,很适合用来做“数据上传 + 远程控制”的入门物联网项目。


1. 准备工作

1.1 硬件准备

本教程以使用行空板 K10 的板载温度传感器和板载 RGB 灯为例。

硬件 用途 示例连接
行空板 K10 运行程序、连接 SIoT、控制硬件 通过 USB 连接电脑
板载温度传感器 采集温度 无需外接 (板载)
板载 RGB 灯 接收 SIoT 指令后亮灭 无需外接 (板载)
电脑 运行 Mind+、访问 SIoT 页面 与行空板 K10 在同一局域网

如果使用的是外接传感器或外接 LED 模块,请根据实际硬件连接修改程序中的引脚和控制逻辑。

1.2软件准备

⚠️ 重要提示(与行空板 M10 的区别):
行空板 M10 拥有独立的 Linux 系统,可以直接在板载系统内运行 SIoT 服务并通过 10.1.2.3 访问。
而行空板 K10 本身没有运行完整操作系统的能力,因此无法在板子上运行 SIoT 服务。
你必须在本地电脑上运行 SIoT 软件(即在电脑端开启并运行该软件服务)。电脑和行空板 K10 必须连接在同一个 Wi-Fi 局域网下,程序中填写的 SIoT 服务器地址 应当是电脑的局域网 IP 地址(例如 192.168.1.183),而**绝对不能填写 **10.1.2.3****。

开始前请确认:

  1. 已安装 Mind+。
  2. 行空板 K10 可以正常连接电脑。
  3. 已在本地电脑上启动并运行了 SIoT 软件。
  4. 电脑和行空板 K10 连接在同一个 Wi-Fi 局域网内。
  5. 电脑浏览器可以正常打开 SIoT Web 管理页面。
  6. 已根据 Mind+ 提示完成行空板 K10 的 MicroPython 固件烧录(仅 MicroPython 模式需要)。

常用连接参数如下:

参数 示例值
Wi-Fi 名称 你的WiFi名称
Wi-Fi 密码 你的WiFi密码
SIoT 服务器地址 实际运行 SIoT 的设备 IP
MQTT 端口 1883
用户名 siot
密码 dfrobot

如果行空板 K10 与电脑通过 Wi-Fi 接入同一网络,请填写 SIoT 服务器在当前局域网中的实际 IP,例如:192.168.1.183。

1.3 本教程使用的 Topic

Topic 通信方向 用途
siot/k10_temp 行空板 K10 -> SIoT 上传温度数据
siot/k10_led SIoT -> 行空板 K10 接收 RGB 灯控制指令

在 SIoT V2 中,可以在 Web 页面中创建 k10_temp、k10_led 两个主题。创建后,程序中使用完整 Topic:

siot/k10_temp
siot/k10_led

2. 上传模式

上传模式适合在课堂中快速完成图形化程序。程序下载到行空板 K10 后,可以脱离电脑独立运行。

2.1 进入上传模式

打开 Mind+ 后,按下面步骤操作:

  1. 点击 新建项目。
  2. 选择 上传模式。
  3. 点击 扩展。
  4. 加载以下扩展库:
扩展库 用途
行空板 K10 控制板载屏幕、传感器和 RGB 灯
Wi-Fi 用于连接局域网无线网络
MQTT / SIoT 连接 SIoT 并收发消息

  1. 连接行空板 K10,并确认端口识别正常。

2.2 设置 SIoT 连接

在程序开始后,先完成 Wi-Fi 连接和 MQTT 初始化。

积木参数建议如下:

设置项 填写内容
WiFi名称 你的WiFi名称
WiFi密码 你的WiFi密码
平台 SIoT V2
服务器地址 实际 SIoT IP
用户名 siot
密码 dfrobot
设置WiFi 设置MQTT
设置WiFi 设置MQTT

参考程序如下:

连接成功后,行空板 K10 屏幕上会出现类似“WIFI连接成功和MQTT连接成功”的提示。

2.3 项目一:上传温度数据到 SIoT

项目效果

行空板 K10 每隔 2 秒读取一次板载温度传感器,并把数据发送到 SIoT:

数据 Topic
温度 siot/k10_temp

积木编写步骤

  1. 在 当程序开始 下先连接 Wi-Fi,并初始化、连接 MQTT/SIoT。
  2. 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
  3. 在循环中读取板载温度。
  4. 将读取的温度发布到 siot/k10_temp,建议使用带“保存到数据库”说明的发布积木。
  5. 在 K10 屏幕上刷新显示当前的温度。
  6. 等待 2 秒后继续循环。

参考程序如下:

查看上传结果

程序上传并运行后,打开 SIoT Web 页面,进入 siot/k10_temp 的数据管理页面。如果可以看到不断更新的数据,说明温度上传成功。

2.4 项目二:通过 SIoT 控制 RGB 灯

项目效果

在 SIoT Web 页面中向 siot/k10_led 发送指令,行空板 K10 根据指令控制板载 RGB 灯。

发送内容 RGB 灯状态
ON 亮起(例如显示绿色)
OFF 关闭

积木编写步骤

  1. 在 MQTT 初始化参数设置里面再订阅一个 siot/k10_led 的主题。
  2. 添加“当 MQTT 接收到消息”事件。
  3. 在事件中判断接收到的消息主题是否为 siot/k10_led。
  4. 如果消息内容是 ON,设置板载 RGB 灯显示绿色,屏幕显示 "灯已打开"。
  5. 如果消息内容是 OFF,关闭板载 RGB 灯,屏幕显示 "灯已关闭"。

参考程序如下:

发送控制指令

打开 SIoT Web 页面,进入 siot/k10_led 主题的数据管理页面。在消息内容中输入 ON,点击发送,RGB 灯应亮起。输入 OFF 并点击发送,RGB 灯应熄灭。

2.5 上传模式综合效果

完成以上两个项目后,可以将它们合并到同一个程序中,使其能够同时完成数据上传和远程控制:

运行效果:


3. MicroPython 积木模式

MicroPython 积木模式结合了图形化拖拽的便利,同时能够显示并生成对应的 MicroPython 源代码,适合中阶学习者。

3.1 进入 MicroPython 积木模式

  1. 打开 Mind+,新建项目。
  2. 切换至 MicroPython 积木模式。
  3. 点击左下角的 扩展 按钮。
  4. 选择并加载 行空板 K10。

3.2 设置 SIoT 连接

在程序开始后,先完成网络连接和 MQTT 客户端的参数初始化。

设置项 填写内容
WiFi名称 你的WiFi名称
WiFi密码 你的WiFi密码
平台 SIoT V2
服务器地址 实际 SIoT IP
用户名 siot
密码 dfrobot
设置WiFi 设置MQTT
设置WiFi 设置MQTT

参考程序如下:

连接成功后,行空板 K10 屏幕上会出现类似“WIFI连接成功和MQTT连接成功”的提示。

3.3 项目一:上传温度数据到 SIoT

项目效果

在 MicroPython 积木模式下,行空板 K10 定时读取并发送温度至 SIoT:

数据 Topic
温度 siot/k10_temp

积木编写步骤

  1. 在 开始 积木下方配置 Wi-Fi 和 MQTT 连接。
  2. 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
  3. 在 重复执行 循环内,使用变量保存板载温度数值。
  4. 使用 MQTT 发布积木,将温度发布到 siot/k10_temp。
  5. 在屏幕上刷新显示当前的温度读数。
  6. 设置等待时间为 2 秒。

参考程序如下:

查看上传结果

运行项目后,在浏览器中登录 SIoT 后台,查看 siot/k10_temp 主题的数据记录,核对是否成功更新。

3.4 项目二:通过 SIoT 控制 RGB 灯

项目效果

在 SIoT Web 页面中向 siot/k10_led 发送指令,行空板 K10 根据指令控制板载 RGB 灯。发送 ON 控制 K10 的板载 RGB 灯点亮(绿色),发送 OFF 控制其关闭。

积木编写步骤

  1. 在 开始 积木下方配置 Wi-Fi 和 MQTT 连接。
  2. 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
  3. 创建事件:“当收到主题 [siot/k10_led] 消息” 积木。
  4. 在事件块内判断消息内容:
    • 若消息 = ON:亮起板载 RGB 灯(绿色),并在屏幕更新状态。
    • 若消息 = OFF:关闭 RGB 灯,并在屏幕更新状态。

参考程序如下:

发送控制指令

在 SIoT 控制面板的 siot/k10_led 主题发送 ON,观察 K10 灯光是否点亮;发送 OFF 观察是否熄灭。

3.5 MicroPython 积木模式综合效果

可以将上传与接收集成在同一个积木工程中,代码参考逻辑组织如下:

运行效果:


4. MicroPython 代码模式

MicroPython 代码模式适合希望进一步理解底层通信、进行代码化和复杂系统扩展的学习者。

4.1 进入 MicroPython 代码模式

  1. 打开 Mind+,新建项目。
  2. 切换至 MicroPython 代码模式。
  3. 点击菜单栏的 选择主板 按钮,下载和加载 行空板K10。

4.2 MicroPython 连接 SIoT 的基本流程

使用 MicroPython 连接 SIoT 时,通常按以下步骤编写:

  1. 导入 WiFi 和 MqttClient 库。
  2. 连接无线 Wi-Fi。
  3. 创建并配置 MqttClient 实例,填写服务器地址、端口、账号和密码。
  4. 使用 connect() 连接 SIoT 服务器。
  5. 使用 publish() 上传传感器数据。
  6. 使用 received() 绑定接收消息的回调函数,并订阅控制 Topic。

4.3 连接 SIoT 的示例

下面代码只完成 Wi-Fi 与 SIoT 连接,用于检查网络与 MQTT 参数设置是否正确。

from k10_base import WiFi, MqttClient     # 导入网络与 MQTT 客户端库
import time                               # 导入时间库,用于延时控制

# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice"               # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011"             # Wi-Fi 密码

SERVER = "192.168.1.183"                  # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883                               # MQTT 通信端口
CLIENT_ID = ""                            # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot"                     # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot"                  # 默认 SIoT 登录密码

# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()

# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网
print("Wi-Fi 连接状态:", wifi.status())                        # 在控制台打印 Wi-Fi 连通状态

# --- 2. 连接 SIoT MQTT ---
if wifi.status() == True or wifi.status() == 1:
    mqttclient.connect(
        server=SERVER,
        port=PORT,
        client_id=CLIENT_ID,
        user=IOT_USERNAME,
        psd=IOT_PASSWORD
    )                                     # 连接 SIoT MQTT 服务器
    print("MQTT 连接状态:", mqttclient.connected())             # 在控制台打印 MQTT 连通状态
else:
    print("Wi-Fi 未连通,无法连接 MQTT")

# --- 主循环维持运行 ---
while True:
    time.sleep(1)                         # 休眠 1 秒,保持连接并降低 CPU 占用

当运行成功后,在终端区域会出现“Wi-Fi 连接状态: True”和“MQTT 连接状态: True”的提示。

重要代码说明:

代码 作用
WiFi() 实例化 Wi-Fi 模块对象
MqttClient() 实例化 MQTT 客户端对象
wifi.connect(...) 连接 Wi-Fi 局域网
mqttclient.connect(...) 连接 SIoT MQTT
mqttclient.connected() 返回 MQTT 连接状态
wifi.status() 返回 Wi-Fi 连接状态

4.4 项目一:上传温度数据到 SIoT

下面代码读取板载温度传感器数据,并发送到 SIoT。

from k10_base import WiFi, MqttClient     # 导入网络与 MQTT 客户端库
from unihiker_k10 import temp_humi, screen # 导入 K10 板载传感器与屏幕控制模块
import time                               # 导入时间库,用于控制延时与主循环频率

# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice"               # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011"             # Wi-Fi 密码

SERVER = "192.168.1.183"                  # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883                               # MQTT 通信端口
CLIENT_ID = ""                            # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot"                     # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot"                  # 默认 SIoT 登录密码

TEMP_TOPIC = "siot/k10_temp"              # 发布温度数据的 MQTT 主题

# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()

# --- 硬件驱动与界面初始化 ---
screen.init(dir=2)                       # 初始化 K10 屏幕(dir=2 为横屏显示)
screen.show_bg(color=0xFFFFFF)           # 设置屏幕背景颜色为白色(0xFFFFFF)

# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网

# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(
    server=SERVER,
    port=PORT,
    client_id=CLIENT_ID,
    user=IOT_USERNAME,
    psd=IOT_PASSWORD
)                                         # 连接 SIoT MQTT 服务器

# --- 主循环:持续读取温度并上传 ---
while True:
    temp = temp_humi.read_temp()          # 读取板载传感器测得的摄氏温度值

    # 发布数据到 SIoT
    mqttclient.publish(topic=TEMP_TOPIC, content=str(temp)) # 向指定 Topic 发布数据

    # 更新屏幕显示
    screen.show_bg(color=0xFFFFFF)        # 清屏(擦除上一次显示的旧文字)
    screen.draw_text(text="实时温度: " + str(temp), x=10, y=20, font_size=24, color=0x0000FF) # 绘制最新温度文字(字号调至 24)
    screen.show_draw()                    # 刷新屏幕显示

    print("已上传温度:", temp)             # 在控制台打印当前温度,便于本地调试
    time.sleep(2)                         # 延时 2 秒,避免数据发送过快

运行项目后,在浏览器中登录 SIoT 后台,查看 siot/k10_temp 主题的数据记录,核对是否成功更新。

4.5 项目二:通过 SIoT 控制 RGB 灯

下面代码订阅 siot/k10_led,当收到 ON 时点亮板载 RGB 灯为绿色,收到 OFF 时关闭。

from k10_base import WiFi, MqttClient     # 导入网络与 MQTT 客户端库
from unihiker_k10 import rgb, screen      # 导入 K10 板载 RGB 灯与屏幕控制模块
import time                               # 导入时间库,用于延时控制

# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice"               # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011"             # Wi-Fi 密码

SERVER = "192.168.1.183"                  # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883                               # MQTT 通信端口
CLIENT_ID = ""                            # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot"                     # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot"                  # 默认 SIoT 登录密码

LED_TOPIC = "siot/k10_led"                # 订阅 LED 控制指令的 MQTT 主题

# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()

# --- 硬件驱动与界面初始化 ---
screen.init(dir=2)                       # 初始化 K10 屏幕(dir=2 为横屏显示)
screen.show_bg(color=0xFFFFFF)           # 设置屏幕背景颜色为白色(0xFFFFFF)

# 屏幕绘制初始状态
screen.draw_text(text="LED灯状态:等待控制", x=0, y=20, font_size=24, color=0x0000FF)
screen.show_draw()                       # 刷新屏幕显示

# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网

# --- 定义 MQTT 消息监听回调函数 ---
def led_callback():
    msg = mqttclient.message(topic=LED_TOPIC) # 获取接收到的消息内容
    if msg is None:
        return

    msg = str(msg).strip()                # 解码并去除两端的空格与换行
    print("收到控制指令:", msg)

    # 根据不同的控制指令切换 RGB 灯亮灭并更新屏幕显示
    if msg in ["ON", "on", "1", "开"]:
        rgb.write(color=0x00FF00)         # 板载 RGB 灯点亮为绿色
        screen.show_bg(color=0xFFFFFF)    # 清屏
        screen.draw_text(text="LED灯状态:打开", x=0, y=20, font_size=24, color=0x00AA00) # 绿色字体显示“打开”
        screen.show_draw()                # 刷新屏幕显示
    elif msg in ["OFF", "off", "0", "关"]:
        rgb.clear()                       # 关闭板载 RGB 灯
        screen.show_bg(color=0xFFFFFF)    # 清屏
        screen.draw_text(text="LED灯状态:关闭", x=0, y=20, font_size=24, color=0xFF0000) # 红色字体显示“关闭”
        screen.show_draw()                # 刷新屏幕显示

# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(
    server=SERVER,
    port=PORT,
    client_id=CLIENT_ID,
    user=IOT_USERNAME,
    psd=IOT_PASSWORD
)                                         # 连接 SIoT MQTT 服务器

# 绑定消息接收回调函数并订阅主题
mqttclient.received(topic=LED_TOPIC, callback=led_callback)

# --- 主循环维持运行 ---
while True:
    time.sleep(0.1)                       # 保持微小延时,维持程序运行,降低 CPU 占用

当运行成功后,在 SIoT Web 页面向 siot/k10_led 发送 ON 或 OFF 控制指令,你就能远程控制行空板 K10 上的 RGB 灯。

4.6 综合示例:温度上传 + RGB 控制

下面代码把上传与控制合并在一起。行空板 K10 边上传数据边响应云端控制。

from k10_base import WiFi, MqttClient     # 导入网络与 MQTT 客户端库
from unihiker_k10 import temp_humi, rgb, screen # 导入 K10 板载传感器、RGB灯与屏幕控制模块
import time                               # 导入时间库,用于延时控制

# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice"               # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011"             # Wi-Fi 密码

SERVER = "192.168.1.183"                  # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883                               # MQTT 通信端口
CLIENT_ID = ""                            # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot"                     # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot"                  # 默认 SIoT 登录密码

TEMP_TOPIC = "siot/k10_temp"              # 发布温度数据的 MQTT 主题
LED_TOPIC = "siot/k10_led"                # 订阅 LED 控制指令 of MQTT 主题

# --- 全局状态变量(用于屏幕画面的统一渲染) ---
current_temp = "读取中..."                # 缓存当前温度值
led_status = "等待控制"                    # 缓存当前 LED 状态
led_color = 0x0000FF                      # LED 状态文字的颜色(初始为蓝色 0x0000FF)

# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()

# --- 屏幕画面统一刷新函数 ---
def update_screen():
    screen.show_bg(color=0xFFFFFF)        # 清空屏幕背景为白色
    # 绘制第一行:实时温度
    screen.draw_text(text="实时温度: " + str(current_temp) + " C", x=10, y=20, font_size=24, color=0x0000FF)
    # 绘制第二行:LED 灯状态(动态色彩:打开显示绿色,关闭显示红色,等待显示蓝色)
    screen.draw_text(text="LED灯状态:" + led_status, x=10, y=65, font_size=24, color=led_color)
    screen.show_draw()                    # 刷新画布,将内容呈呈现屏幕上

# --- 硬件驱动与界面初始化 ---
screen.init(dir=2)                       # 初始化 K10 屏幕(dir=2 为横屏显示)
update_screen()                           # 绘制初始画面

# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网

# --- 定义 MQTT 消息监听回调函数 ---
def led_callback():
    global led_status, led_color          # 声明使用全局变量
    msg = mqttclient.message(topic=LED_TOPIC) # 获取接收到的消息
    if msg is None:
        return

    msg = str(msg).strip()                # 解码并去除两端的空格与换行
    print("收到控制指令:", msg)

    # 切换 RGB 灯状态并更新屏幕的全局变量
    if msg in ["ON", "on", "1", "开"]:
        rgb.write(color=0x00FF00)         # 板载 RGB 灯点亮为绿色
        led_status = "打开"
        led_color = 0x00AA00              # 文字设为绿色
    elif msg in ["OFF", "off", "0", "关"]:
        rgb.clear()                       # 关闭板载 RGB 灯
        led_status = "关闭"
        led_color = 0xFF0000              # 文字设为红色
    
    update_screen()                       # 立即更新屏幕画面

# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(server=SERVER,port=PORT,client_id=CLIENT_ID,user=IOT_USERNAME,psd=IOT_PASSWORD
)                                         # 连接 SIoT MQTT 服务器

# 绑定消息接收回调函数并订阅主题
mqttclient.received(topic=LED_TOPIC, callback=led_callback)

# --- 主循环:边上传数据,边等待回调响应 ---
while True:
    current_temp = temp_humi.read_temp()  # 读取板载传感器最新的摄氏温度值

    # 发布温度数据到 SIoT 服务器
    mqttclient.publish(topic=TEMP_TOPIC, content=str(current_temp))

    print("已上传温度:", current_temp)     # 在控制台打印当前温度值
    update_screen()                       # 定时刷新屏幕画面显示最新温度

    time.sleep(2)                         # 延时 2 秒,避免数据发送过快

如果程序运行正常,可以在 SIoT 中看到温度数据,同时也可以通过发送 ON、OFF 控制 RGB 灯。